---
title: Astro에서 Bun 사용하기
description: Astro 사이트에서 Bun을 사용하는 방법을 알아봅니다.
type: recipe
i18nReady: true
---

[Bun](https://bun.sh/)은 올인원 JavaScript 런타임 및 툴킷입니다. 자세한 내용은 [Bun 문서](https://bun.sh/docs)를 확인하세요.

:::caution
Bun을 Astro와 사용할 때 미완성된 기능들을 마주할 수 있으며, 일부 통합은 정상적으로 동작하지 않을 수 있습니다. 자세한 내용은 [Astro와 함께 사용하는 방법을 다루는 Bun 공식 문서](https://bun.sh/guides/ecosystem/astro)를 참조하세요.

Bun을 사용하면서 문제가 발생하면, [Bun의 Github 저장소에서 직접 issue를 생성해주세요](https://github.com/oven-sh/bun/issues/new/choose).
:::

## 전제 조건

- Bun이 로컬 기기에 설치되어 있어야 합니다. Bun 공식 문서의 [설치 방법](https://bun.sh/docs/installation)을 참조하세요.

## Bun으로 새 Astro 프로젝트 생성

다음 `create-astro` 명령어를 사용하여 Bun으로 새 Astro 프로젝트를 생성하세요.

```bash
bun create astro my-astro-project-using-bun
```

## 종속성 설치

CLI 마법사에서 "Install dependencies?" 단계를 건너뛴 경우, 계속하기 전에 반드시 의존성을 설치하세요.

```bash
bun install
```

## 타입 추가

Bun은 [`@types/bun`](https://www.npmjs.com/package/@types/bun) 패키지를 제공하며, 여기에는 Bun의 런타임 타입이 포함되어 있습니다.

다음 명령어를 사용하여 `@types/bun`을 설치합니다.

```sh
bun add -d @types/bun
```

## CLI 설치 플래그

### 통합 사용하기

`astro add` 명령어를 통해 모든 공식 Astro 통합을 사용할 수 있습니다.

```bash
bun astro add react
```

### 테마 또는 시작 템플릿 사용하기

`create astro` 명령에 `--template` 인수를 전달하여 [공식 예제](https://github.com/withastro/astro/tree/main/examples) 또는 GitHub 저장소의 메인 브랜치를 기반으로 새로운 Astro 프로젝트를 시작할 수 있습니다.

터미널에서 공식 Astro 시작 템플릿 이름이나 사용하려는 테마의 GitHub 사용자 이름 및 리포지토리 이름으로 대체하여 다음 명령어를 실행하세요.

```bash
# 공식 예제를 사용하여 새 프로젝트를 생성합니다.
bun create astro@latest --template <example-name>
# GitHub 저장소의 메인 브랜치를 기반으로 새 프로젝트를 생성합니다.
bun create astro@latest --template <github-username>/<github-repo>
```

## 개발 및 빌드하기

개발 서버를 실행하려면 다음 명령어를 사용하세요.

```bash
bun run dev
```

### 사이트 빌드 및 미리보기

사이트를 빌드하려면 다음 명령어를 사용하세요.

```bash
bun run build
```

빌드가 완료되면 터미널에서 적절한 미리보기 명령어(예: `bun run preview`)를 실행하세요. 그러면 동일한 브라우저 미리보기 창에서 빌드된 버전의 사이트를 로컬에서 직접 확인할 수 있습니다.

## 테스팅

Bun은 [`bun test` 명령어](https://bun.sh/docs/cli/test)를 통해 Jest와 호환되는 빠른 내장 테스트 실행기를 제공합니다. 또한 다른 [Astro용 테스트 도구](/ko/guides/testing/)를 사용할 수도 있습니다.

## 공식 리소스

- [Astro 및 Bun을 사용하여 앱 구축](https://bun.sh/guides/ecosystem/astro)

## 커뮤니티 리소스

Astro와 Bun을 함께 사용하고 계신가요? 이 페이지에 여러분의 블로그 게시물이나 동영상을 추가하세요!

- [Bun을 사용하여 Cloudflare Pages 사이트 빌드](https://blog.otterlord.dev/posts/hello-from-bun/) - 블로그 게시물
- [Astro 및 Cloudflare Pages와 함께 Bun 사용하기](https://handerson.hashnode.dev/using-bun-with-astro-and-cloudflare-pages) - 블로그 게시물
